home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Complementary Applications 2004 February / SGI IRIX 6.5 Complementary Applications 2004 February.iso / dist / OpenOffice.idb / usr / OpenOffice / help / en / common.jar / text / common / 02 / 01170202.xml < prev    next >
Encoding:
Extensible Markup Language  |  2002-01-24  |  9.4 KB  |  98 lines
  1. <?xml version="1.0" encoding="utf-8"?>
  2. <html><head><title>Events</title><meta name="filename" content="text/common/02/01170202"/><meta name="language" content="en-US"/><help:css-file-link xmlns:help="http://openoffice.org/2000/help"/><!--The CSS style header method for setting styles--><style type="text/css">
  3.  
  4.         p.P1{
  5.                 }
  6.         p.P2{
  7.                 }
  8.         p.P3{
  9.                 }
  10.         p.P4{
  11.                 }
  12.         p.P5{
  13.                 }
  14.         p.P6{
  15.                 }
  16.         span.T1{
  17.                 font-weight:bold;}
  18.         </style></head><body>
  19.    
  20.    
  21.    <help:to-be-embedded Eid="ereignisse" xmlns:help="http://openoffice.org/2000/help">
  22.    <p class="Head1"><help:key-word value="forms; events" tag="kw65913_1"/><help:key-word value="events; forms" tag="kw65913_2"/><help:link Id="65913">Events</help:link></p>
  23.    <p class="Paragraph">In this tab page, you can assign a macro to certain events which occur in a form.</p>
  24.    </help:to-be-embedded>
  25.    <help:popup Id="65594" Eid="formulareigenschaftenereignisse" xmlns:help="http://openoffice.org/2000/help"><help:embedded Id="65598" Eid="wie"/></help:popup>
  26.    <p class="Paragraph">If the form has a subform, the subform also reacts to events in the parent form.</p>
  27.    <p class="Paragraph">Linking an event with a macro makes sense if you have to repeatedly react to a very specific event in the form in a very specific way. To do so, first write a macro that contains all the commands to be executed when the event happens; then assign this macro to the respective event. For this purpose, simply click the <span class="T1">... </span><text:s text:c="" xmlns:text="http://openoffice.org/2000/text"/>button beside the respective event; a <help:link Id="67665" xmlns:help="http://openoffice.org/2000/help">dialog</help:link> will then open where you can select the macro.</p>
  28.    <p class="Paragraph">The following actions can be configured individually, i.e. you can use your own dialogs to depict an action:</p>
  29.    <ul class="L1">
  30.     <li class="">
  31.      <p class="P2">Displaying an error message,</p>
  32.     </li>
  33.    </ul>
  34.    <ul class="L2">
  35.     <li class="">
  36.      <p class="P3">Confirming a delete process (for data records),</p>
  37.     </li>
  38.    </ul>
  39.    <ul class="L3">
  40.     <li class="">
  41.      <p class="P4">Querying parameters,</p>
  42.     </li>
  43.    </ul>
  44.    <ul class="L4">
  45.     <li class="">
  46.      <p class="P5">Checking input when saving a data record.</p>
  47.     </li>
  48.    </ul>
  49.    <p class="Paragraph">This means, for example, you can issue a "confirm deletion" request such as "Really delete customer xyz?" when deleting a data record.</p>
  50.    <p class="Paragraph">In the following, all events defined for a form that can be linked to a macro are described:</p>
  51.    <help:to-be-embedded Eid="reset_update" xmlns:help="http://openoffice.org/2000/help">
  52.    <p class="Head2"><help:help-id value="HID_EVT_APPROVERESETTED"/>Before resetting</p>
  53.    <p class="Paragraph"><help:help-text value="visible">This event occurs before a formula is reset.</help:help-text> The linked macro can, for example, prevent this action by returning "FALSE".</p>
  54.    <p class="Paragraph">A formula is reset if one of the following conditions is met:</p>
  55.    <ul class="L5">
  56.     <li class="">
  57.      <p style="">The user presses an (HTML) button that is defined as a reset button</p>
  58.     </li>
  59.     <li class="">
  60.      <p style="">A new and empty record is created in a formula that is linked to a data source. In the last record, for example, the <span style="font-weight:bold;">Next Record</span> button may be pressed.</p>
  61.     </li>
  62.    </ul>
  63.    <p class="Head2"><help:help-id value="HID_EVT_RESETTED"/>After resetting</p>
  64.    <p class="Paragraph"><help:help-text value="visible">This event occurs after a formula has been reset.</help:help-text></p>
  65.    <p class="Head2"><help:help-id value="HID_EVT_BEFOREUPDATE"/>Before update</p>
  66.    <p class="Paragraph"><help:help-text value="visible">This event occurs before the control content changed by the user is written into the data source.</help:help-text> The linked macro can, for example, prevent this action by returning "FALSE".</p>
  67.    <p class="Head2"><help:help-id value="HID_EVT_AFTERUPDATE"/>After update</p>
  68.    <p class="Paragraph"><help:help-text value="visible">This event occurs after the control content changed by the user has been written into the data source.</help:help-text></p>
  69.    </help:to-be-embedded>
  70.    <p class="Head2"><help:help-id value="HID_EVT_SUBMITTED" xmlns:help="http://openoffice.org/2000/help"/>Before Submitting</p>
  71.    <p class="Paragraph"><help:help-text value="visible" xmlns:help="http://openoffice.org/2000/help">This event occurs before the formula data is sent.</help:help-text></p>
  72.    <p class="Head2"><help:help-id value="HID_EVT_LOADED" xmlns:help="http://openoffice.org/2000/help"/>When loading</p>
  73.    <p class="Paragraph"><help:help-text value="visible" xmlns:help="http://openoffice.org/2000/help">This event occurs directly after the formula has been loaded.</help:help-text></p>
  74.    <p class="Head2"><help:help-id value="HID_EVT_RELOADING" xmlns:help="http://openoffice.org/2000/help"/>Before reloading</p>
  75.    <p class="Paragraph"><help:help-text value="visible" xmlns:help="http://openoffice.org/2000/help">This event occurs before this formula is reloaded.</help:help-text> The data content has not yet been refreshed.</p>
  76.    <p class="Head2"><help:help-id value="HID_EVT_RELOADED" xmlns:help="http://openoffice.org/2000/help"/>When reloading</p>
  77.    <p class="Paragraph"><help:help-text value="visible" xmlns:help="http://openoffice.org/2000/help">This event occurs directly after this formula has been reloaded.</help:help-text> The data content has already been refreshed.</p>
  78.    <p class="Head2"><help:help-id value="HID_EVT_UNLOADING" xmlns:help="http://openoffice.org/2000/help"/>Before unloading</p>
  79.    <p class="Paragraph"><help:help-text value="visible" xmlns:help="http://openoffice.org/2000/help">This event occurs before this formula is unloaded, that is, separated from its data source.</help:help-text></p>
  80.    <p class="Head2"><help:help-id value="HID_EVT_UNLOADED" xmlns:help="http://openoffice.org/2000/help"/>When unloading</p>
  81.    <p class="Paragraph"><help:help-text value="visible" xmlns:help="http://openoffice.org/2000/help">This event occurs directly after this formula is unloaded, that is, separated from its data source.</help:help-text></p>
  82.    <p class="Head2"><help:help-id value="HID_EVT_CONFIRMDELETE" xmlns:help="http://openoffice.org/2000/help"/>Confirm delete</p>
  83.    <p class="Paragraph"><help:help-text value="visible" xmlns:help="http://openoffice.org/2000/help">This event occurs as soon as data is deleted from the formula.</help:help-text> The linked macro can, for example, request confirmation in a dialog.</p>
  84.    <p class="Head2"><help:help-id value="HID_EVT_APPROVEROWCHANGE" xmlns:help="http://openoffice.org/2000/help"/>Before record action</p>
  85.    <p class="Paragraph"><help:help-text value="visible" xmlns:help="http://openoffice.org/2000/help">This event occurs before the current record is changed, for example, by editing, deleting or pasting.</help:help-text> The linked macro can, for example, request confirmation in a dialog.</p>
  86.    <p class="Head2"><help:help-id value="HID_EVT_ROWCHANGE" xmlns:help="http://openoffice.org/2000/help"/>After record action</p>
  87.    <p class="Paragraph"><help:help-text value="visible" xmlns:help="http://openoffice.org/2000/help">This event occurs directly after the current record has been changed, for example, by editing, deleting or inserting.</help:help-text></p>
  88.    <p class="Head2"><help:help-id value="HID_EVT_POSITIONING" xmlns:help="http://openoffice.org/2000/help"/>Before record change</p>
  89.    <p class="Paragraph"><help:help-text value="visible" xmlns:help="http://openoffice.org/2000/help">This event occurs before the current record pointer is changed, for example, via the <span class="T1">Next Record</span> button</help:help-text>. The linked macro can, for example, prevent this action by returning "FALSE".</p>
  90.    <p class="Head2"><help:help-id value="HID_EVT_POSITIONED" xmlns:help="http://openoffice.org/2000/help"/>After record change</p>
  91.    <p class="Paragraph"><help:help-text value="visible" xmlns:help="http://openoffice.org/2000/help">This event occurs directly after the current record pointer is changed, for example, via the <span class="T1">Next Record</span> button</help:help-text>.</p>
  92.    <p class="Head2"><help:help-id value="HID_EVT_APPROVEPARAMETER" xmlns:help="http://openoffice.org/2000/help"/>Fill parameter</p>
  93.    <p class="Paragraph"><help:help-text value="visible" xmlns:help="http://openoffice.org/2000/help">This event occurs when the formula to be loaded has parameters that must be filled out.</help:help-text> The data source of the formula can, for example, be the following SQL command:</p>
  94.    <p class="Paragraph">SELECT * FROM address WHERE name=:name</p>
  95.    <p class="Paragraph">:name is a parameter that must be filled out when loading. The parameter is automatically filled out from the principal formula as long as this is possible. If the parameter cannot be filled out, this event is called and a linked macro can fill out the parameter.</p>
  96.    <p class="Head2"><help:help-id value="HID_EVT_ERROROCCURED" xmlns:help="http://openoffice.org/2000/help"/>Error occurred</p>
  97.    <p class="Paragraph"><help:help-text value="visible" xmlns:help="http://openoffice.org/2000/help">This event occurs if an error occurs when accessing the data source.</help:help-text> This applies to formulas, list boxes and combo boxes.</p>
  98.   </body></html>